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Development Timeline 


Started development January 2015 

Began with thin C implementation using legacy DRM/KMS ABI 
Converted to C++ with libdrm abstraction 

Moved to C++11 to exploit language safety features 

Added embedded GL compositor for full/partial squashing 
Shipped on Pixel C in December 2015 

Planner allows for more granular device/application specific rules 
Vulkan compositor 
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DRM/KMS 


Code Overview 


hwc device open() 


Em rty. get("hwe.drm.device" 
DrmResources::Init() put Ajer Nok drmModeGetResources(fd) 


DrmCompositor::Init() 


Planner::Createlnstance() 


for each connector... 


F Worker::Init 
DrmDisplayCompositor::Init() rameWorker::Init() 


DrmCompositorWorker::Init() 


Importer::Createlnstance() 


Code Overview (continued) 


e hwc set(dev, contents) 
encapsulate everything in C+11 in case we ever fail 
import every layer we need to composite (either with GL or overlays) 
assign each layer a release fence 
DrmCompositor::CreateComposition 
DrmComposition::SetLayers(contents) 
a DrmDisplayComposition::SetLayers(display_layers) 
o | DrmCompositor::QueueComposition(composition) 
= DrmComposition::Plan 
e foreach display: 
o DrmDisplayComposition::Plan(squash state, primary planes, overlay planes) 
m reading and writing to squash state 
m _Planner::ProvisionPlanes 
m  DrmDisplayComposition::SeparateLayers 
m assign fences to layers in order of completion 


Or 0 "© 0 


m for each display: 
e  DrmDisplayCompositor::QueueComposition(display_ composition) 
o Push display composition onto composition queue 
o return 


Code Overview (continued) 


e DrmDisplayCompositor::Composite() 
o creates GL Compositor (called pre_compositor in code) if needed 
o pops a DrmDisplayComposition off the queue 
o  DrmDisplayCompositor::PrepareFrame(display_ composition) 
m  ApplySquash(display comp) OR reuse the last squash 
e _ GLCompositor::Composite 
m ApplyPreComposite(display_comp) 
e _ GLCompositor::Composite 
o queue finished frame onto the frame queue 
e FrameWorker::Routine() 
o pops a finished DrmDisplayComposition of the queue 
o DrmDisplayCompositor::ApplyFrame(composition) 
m DrmDisplayCompositor::CommitFrame 
e drmModeAtomicCommit 
m Blank the display on error 
m Signal composition completion 
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DRM/KMS 


Rectangle Separator 


Dialog Box 


struct DrmCompositionRegion { 
DrmHwcRect<int> frame; 
std::vector<size t> source layers; 


}; 


GL Compositor 


uses separated regions directly 

generates a shader for each layer depth 

renders each rectangle region with one draw call 

no blending hardware used at all 

optimization: blending done within shader 

for layer import, uses NV hack: EGL NATIVE HANDLE ANDROID NVX 
for framebuffer import, uses standard EGL ANDROID image native buffer 
optimization: cache framebuffers using weakptr 


Planner 


Introduced with Android N 

Planner runs every time the composition changes 

Platform register plan stages in priority order 

Plan stages map SurfaceFlinger layers to hardware planes 
After all stages finish, all layers should be mapped 
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DRM/KMS 


HWC2 


| drm hwetw | drm hwetwo | 


DrmDisplayCompositor[0] DrmDisplayCompositor[n] 


Contributing to drm_hwcomposer 


e Upstream source hosted on chromium.org gerrit 
e External contributions welcome (thanks robher!) 


https://www.chromium.org/android/contributing-to-drm _hwcomposer 


AMA 


